Batch transfer between Delbank bank accounts
To transfer to several Delfinance accounts, you only need to inform the beneficiary bank account numbers.
- URL
- cURL
POST 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch'
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch' \
--header 'Content-Type: application/json-patch+json' \
--header 'IdempotencyKey: 8ea756b5-897a-44a1-bd15-ba94a30ef86b' \
--header 'accept: text/plain' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5qyPF7mnDAIp3DU7lrh6Q+aGXdyXbNadpWwrpX7YeUyssHInV1E823VibR+KhYK4NGys1ihS2gvjqW1P3Rm59rb' \
--data '[
{
"externalId": "{{guid}}",
"amount": 1,
"beneficiaryAccountNumber": "10138"
},
{
"externalId": "{{guid}}",
"amount": 2,
"beneficiaryAccountNumber": "37990"
},
{
"externalId": "{{guid}}",
"amount": 3,
"beneficiaryAccountNumber": "10073"
},
{
"externalId": "{{guid}}",
"amount": 4,
"beneficiaryAccountNumber": "32743"
}
]'
Headers
| Name | Description |
|---|---|
| x-delbank-api-key | Required. API key |
| IdempotencyKey | Required. Requisition's idempotency key. Inform a GUID, being new to every requisition. |
Body
| Name | Type | Description |
|---|---|---|
| externalId | string | External identification for reconciliation in the client system. This amount will be returned during the transfer query (both via payer and beneficiary).Webhook to the beneficiary account |
| amount | number | Required. Transfer amount. |
| beneficiaryAccountNumber | string | Required. Beneficiary account number. |
[
{
"externalId": "555171d8-0c55-4fd5-978d-25733d3cbb68",
"amount": 1,
"beneficiaryAccountNumber": "10138"
},
{
"externalId": "cbd675ff-ba9a-4f1e-8850-62bf6a496f38",
"amount": 2,
"beneficiaryAccountNumber": "37990"
},
{
"externalId": "3e44cde3-fd21-4969-9954-de5d44226a88",
"amount": 3,
"beneficiaryAccountNumber": "10073"
},
{
"externalId": "db9d5cab-8647-4bd4-a5b1-e6738b51dd2d",
"amount": 4,
"beneficiaryAccountNumber": "32743"
}
]
Response
The status code 200 will indicate success in the transaction.
Being successful, the return will bring the following fields in JSON format:
Note
🚧 These informations will be returned after the transfer creation and transfer query.
[
{
"id": "f235ad70-be15-4216-b791-eb75c86c0ad4",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 1.0,
"createdAt": "2024-12-05T21:04:41.7533699Z",
"transferAt": "2024-12-05T21:04:41.7533699Z",
"transferredAt": "2024-12-05T21:04:41.7533699Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "10138",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "11468192000181",
"name": "FIDC DELCRED",
"email": "[email protected]",
"type": "LEGAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "a406649b-c298-4cf8-8d9b-27e0f43155c0",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 2.0,
"createdAt": "2024-12-05T21:04:41.8261637Z",
"transferAt": "2024-12-05T21:04:41.8261637Z",
"transferredAt": "2024-12-05T21:04:41.8261637Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "4545454546593",
"name": "Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "37990",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "999999921567",
"name": "EDUARDO",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "d4257999-d350-4ee5-9a5d-52ec3d346cdc",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 3.0,
"createdAt": "2024-12-05T21:04:41.8372496Z",
"transferAt": "2024-12-05T21:04:41.8372496Z",
"transferredAt": "2024-12-05T21:04:41.8372496Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "10073",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "10613462939",
"name": "DOUGLAS ABREU DE VINÍCIUS",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "0e53992c-4f32-4270-ae0e-8f1b85cb8ceb",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 4.0,
"createdAt": "2024-12-05T21:04:41.8464382Z",
"transferAt": "2024-12-05T21:04:41.8464382Z",
"transferredAt": "2024-12-05T21:04:41.8464382Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "32743",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "12345678911",
"name": "DOUGLA ABREU",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
}
]